home *** CD-ROM | disk | FTP | other *** search
/ Collection of Tools & Utilities / Collection of Tools and Utilities.iso / clipper / rshpcx13.zip / RSHPCX13.DOC < prev    next >
Text File  |  1993-06-18  |  7KB  |  195 lines
  1. RShowPCX v1.3 - 17 June 1993                      (c) 1993  Rolf van Gelder
  2. ===========================================================================
  3.  
  4.  
  5.      -+- UN-REGISTERED COPY OF R_SHOWPCX() (CLIPPER 5.01a VERSION) -+-
  6.  
  7.  
  8. RSHOWPCX LIBRARY ----------------------------------------------------------
  9.  
  10. RShowPCX is a shareware Clipper 5.01a library which contains a function
  11. to display a .PCX graphics file.
  12.  
  13. Because the library is written using the ASSEMBLER language the function
  14. works VERY FAST !!
  15.  
  16. Some SUPER VGA adaptors are supported.
  17.  
  18. RShowPCX is perfect to display Company logo's, graphs, wallpapers etc.
  19.  
  20. On request a Clipper Summer '87 version is available.
  21.  
  22.  
  23. DESCRIPTION ---------------------------------------------------------------
  24.  
  25. Syntax   : <nRetCode>  := R_ShowPCX ( cFileName[,bCodeBlock[,lStayGraph]] )
  26.  
  27. Argument : <cFileName>  = Name of the .PCX-file to be displayed
  28.                           Default extension is .PCX
  29.  
  30.            <bCodeBlock> = CodeBlock which is evaluated after
  31.                           the picture is displayed
  32.                           Default codeblock : { || Inkey (0) }
  33.                           *** Clipper 5.01a version only ***
  34.  
  35.            <lStayGraph> = .T. : stay in GRAPHIC MODE after displaying
  36.                                 the picture (leaving the picture on the
  37.                                 screen)
  38.                           .F. : return to TEXT MODE after displaying
  39.                                 the picture (the screen is cleared)
  40.                                 ( = DEFAULT )
  41.  
  42. Returns  : <nRetCode>   = Numeric return code
  43.                           0 = Picture displayed okay
  44.                           1 = Error opening PCX-file
  45.                           2 = Error reading PCX-file
  46.                           3 = File has no legal PCX format
  47.                           4 = Illegal number of Bits-Per-Pixel
  48.                           5 = PCX-file has unsupported dimensions
  49.                           6 = PC has unsupported SUPER VGA card
  50.                           7 = PC has no EGA/VGA adaptor
  51.                           8 = PCX-file not found
  52.                           9 = Parameter error
  53. SUPPORTED ADAPTORS AND VIDEO MODES ----------------------------------------
  54.  
  55. Adaptor         Max Dimensions  Colors  Video mode
  56.                 (width*height)
  57.  
  58. Standard EGA    640 x 350       16      10h
  59. Standard VGA    640 x 480       16      12h
  60.  
  61. Standard VGA    320 x 200       256     13h
  62. Super VGA       640 x 480       256     Super VGA mode
  63.  
  64. At this moment the following SUPER VGA adaptors are AUTOMATICALLY
  65. DETECTED and used :
  66.  
  67. - TRIDENT 8800
  68. - TRIDENT 8900
  69. - TSENG ET 4000
  70.  
  71. More adaptors will be supported in the near future.
  72. HISTORY -------------------------------------------------------------------
  73.  
  74. Version 1.3  (17/06/93)
  75. - Bug fixed: Displaying 256 color pics with an ODD width (e.g. 331x234x256)
  76. - Bug fixed: Displaying 16 color pics with a dimension < (640 x 480)
  77.  
  78. Version 1.2  (14/03/93)
  79. - <lStayGraph> parameter added
  80.  
  81. Version 1.1
  82. - <bCodeBlock> parameter added
  83.  
  84. Version 1.0
  85. - Initial release (worldwide)
  86.  
  87. ===========================================================================
  88. REGISTRATION --------------------------------------------------------------
  89.  
  90. RShowPCX is a Shareware product. It is available through Users Groups,
  91. Bulletin Boards, etc. You have the opportunity to try the program at
  92. no charge to see if it meets your needs. If you continue to use the
  93. program after evaluation, please complete the registration form at the
  94. end of this document and send it with a registration fee of $10 to:
  95.  
  96.                         Ing. R.P.S. van Gelder
  97.                         Binnenwiertzstraat 27
  98.                         5615 HG  EINDHOVEN
  99.                         THE NETHERLANDS
  100.  
  101.  
  102. BENEFITS OF REGISTRATION
  103.  
  104. The UNREGISTERED version of RShowPCX displays a registration message
  105. before displaying the PCX-file.
  106.  
  107. 1) A registered version of RShowPCX which will be sent to you by E-MAIL.
  108.  
  109.    !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
  110.    !! THE REGISTERED VERSION DOESN'T DISPLAY THE REGISTRATION MESSAGE.  !!
  111.    !! ALSO THE 5 SECONDS DELAY WILL BE GONE.                            !!
  112.    !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
  113.  
  114. 2) Run-time royalty-free license. You will be free to integrate RShowPCX
  115.    into your Clipper applications without having to pay any royalty or
  116.    fee for doing so. You may also distribute or market any such 
  117.    applications royalty-free.
  118.  
  119. 3) Support through E-Mail.
  120.  
  121.    E-Mail addresses :
  122.  
  123.    Internet: RCROLF@urc.tue.nl
  124.    Bitnet  : RCROLF@heitue5
  125.  
  126.  
  127. USER GROUPS/SHAREWARE DISTRIBUTORS ----------------------------------------
  128.  
  129. PC User Groups are welcome to add RShowPCX to their libraries under the
  130. following conditions :
  131.  
  132. 1) It must be completely unmodified
  133.  
  134. 2) A diskette/copying fee of $5 of less is charged; and
  135.  
  136. 3) This documentation file MUST be included.
  137.  
  138. I would appreciate notification that you have added RShowPCX
  139. to your library.
  140.  
  141. If you received RShowPCX through either a user group or a shareware
  142. distributor, please remember that the diskette fee you payed DOES NOT
  143. constitute licensing the software, and you are still obligated to 
  144. register if you decide to use RShowPCX.
  145.  
  146.  
  147. DISCLAIMER ----------------------------------------------------------------
  148.  
  149. The copyright owner disclaims all warranties and is not liable for
  150. damages of any kind. By using RShowPCX you agree to this.
  151. REGISTRATION FORM ---------------------------------------------------------
  152.  
  153. To register RShowPCX (v1.3), send this form with a $10 bill to:
  154.  
  155.  
  156.                         Ing. R.P.S. van Gelder
  157.                         Binnenwiertzstraat 27
  158.                         5615 HG  EINDHOVEN
  159.                         THE NETHERLANDS
  160.  
  161.  
  162.             Name : ________________________________________________________
  163.  
  164.          Address : ________________________________________________________
  165.  
  166. City, State, Zip : ________________________________________________________
  167.  
  168.          Country : ________________________________________________________
  169.  
  170.   E-Mail address : ________________________________________________________
  171.  
  172. (Super-)VGA card : ________________________________________________________
  173.  
  174.  !! Important !! : WHICH VERSION OF RSHOWPCX () DO YOU WANT ?????????
  175.  
  176.                    [ ]  Clipper Summer '87
  177.                    [ ]  Clipper 5.01a
  178.  
  179.  
  180. Where did you get your copy of RShowPCX ?
  181.  
  182. ___________________________________________________________________________
  183.  
  184.  
  185. Ideas or suggestions for future revisions of RShowPCX v1.3 :
  186.  
  187. ___________________________________________________________________________
  188.  
  189. ___________________________________________________________________________
  190.  
  191. ___________________________________________________________________________
  192.  
  193. ___________________________________________________________________________
  194.  
  195. ___________________________________________________________________________